﻿<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="../helpproject.xsl" ?>
<topic template="Default" lasteditedby="Geert" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../helpproject.xsd">
  <title translate="true">Getting beta versions via NuGet</title>
  <keywords>
    <keyword translate="true">Beta</keyword>
    <keyword translate="true">NuGet</keyword>
    <keyword translate="true">Packages</keyword>
  </keywords>
  <body>
    <header>
      <para styleclass="Heading1"><text styleclass="Heading1" translate="true">Getting beta versions via NuGet</text></para>
    </header>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">Starting on December 21, 2011, beta versions of Catel are published to NuGet. This way, it is possible to give users that like to live on the edge a change to update their packages via NuGet.</text></para>
    <para styleclass="Heading1"><text styleclass="Heading1" translate="true">Strange versioning</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">The versioning of the beta versions is a bit strange. This is due to a bug in NuGet which does not support the full SemVer standard to include build numbers. Therefore, the beta versions are always 1 less than the next official version.</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">For example, say that version 2.4 is currently the official version, and the team is working towards version 2.5. Then all beta versions for 2.5 will have this version number:</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">2.4.[yyMMddHHmm]-beta (thus on December 21st 2011, 10:41, the version would be 2.4.1112211041-beta).</text></para>
    <para styleclass="Notes"><text styleclass="Notes" translate="true">First idea was to include the full year, but then the number became too large. Therefore, 20 of 2011 is stripped (we will think of a solution for this in the year 2099)</text></para>
    <para styleclass="Heading1"><text styleclass="Heading1" translate="true">Installing the beta via the NuGet</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">Unfortunately, the NuGet package manager does support pre-releases. So, the beta versions must be installed via the shell. This example installs </text><text styleclass="Normal" style="font-style:italic;" translate="true">Catel.Extensions.Controls </text><text styleclass="Normal" style="font-style:normal;" translate="true">as a package. However, to install other packages simple change the ID (name) of the package.</text></para>
    <para styleclass="Normal"><text styleclass="Normal" style="font-weight:bold;" translate="true">Installing the latest beta</text></para>
    <para styleclass="Code Example"><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Install-Package</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Catel.Extensions.Controls</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">–IncludePrerelease</text></para>
    <para styleclass="Normal"><text styleclass="Normal" style="font-weight:bold;" translate="true">Installing a specific beta</text></para>
    <para styleclass="Code Example"><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Install-Package</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Catel.Extensions.Controls</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">–IncludePrerelease -version 2.4.1112211041-beta</text></para>
    <para styleclass="Normal"><text styleclass="Normal" style="font-weight:bold;" translate="true">Updating to the latest beta</text></para>
    <para styleclass="Code Example"><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Update-Package</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Catel.Extensions.Controls</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">–IncludePrerelease</text></para>
    <para styleclass="Normal"><text styleclass="Normal" style="font-weight:bold;" translate="true">Updating to a specific beta</text></para>
    <para styleclass="Code Example"><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Update-Package</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Catel.Extensions.Controls</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">–IncludePrerelease -version 2.4.1112211041-beta</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">Updating to the latest stable version</text></para>
    <para styleclass="Code Example"><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Update-Package</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#ffffff;" translate="true">&#32;</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; color:#000000;" translate="true">Catel.Extensions.Controls</text></para>
  </body>
</topic>
